.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "BSTONE" 6 "2023-01-11" "1.1.12" "SlackBuilds.org"
.SH NAME
bstone \- source port of the Blake Stone games
.\" RST source for bstone(6) man page. Convert with:
.
.\" rst2man.py bstone.rst > bstone.6
.
.\" rst2man.py comes from the SBo development/docutils package.
.
.SH SYNOPSIS
.sp
bstone [\fI\-options\fP]
.SH DESCRIPTION
.sp
BStone is a source port of Blake Stone game series: Aliens of Gold and Planet Strike.
.sp
Features:
.INDENT 0.0
.IP \(bu 2
High resolution rendering of world (extended vanilla engine)
.IP \(bu 2
Modern and vanilla controls
.IP \(bu 2
Allows to customize control bindings
.IP \(bu 2
Separate volume control of sound effects and music
.UNINDENT
.sp
Supported games:
.INDENT 0.0
.IP \(bu 2
Aliens of Gold v1.0 full
.IP \(bu 2
Aliens of Gold v2.0 full
.IP \(bu 2
Aliens of Gold v2.1 full
.IP \(bu 2
Aliens of Gold v3.0 full
.IP \(bu 2
Aliens of Gold v3.0 shareware
.IP \(bu 2
Planet Strike v1.0
.IP \(bu 2
Planet Strike v1.1
.UNINDENT
.sp
This man page only describes the command\-line options. For full documentation,
see /usr/doc/bstone\-1.1.12/README.md
.SH OPTIONS
.INDENT 0.0
.TP
.B \fB\-\-version\fP
Outputs the port\(aqs version to standard output and into message box.
.TP
.B \fB\-\-aog_sw\fP
Switches the port to "Blake Stone: Aliens Of Gold (shareware)" mode.
If appropriate data files are not found, the port will fail.
.TP
.B \fB\-\-aog\fP
Switches the port to "Blake Stone: Aliens Of Gold" mode.
If appropriate data files are not found, the port will fail.
.TP
.B \fB\-\-ps\fP
Switches the port to "Blake Stone: Planet Strike" mode.
If appropriate data files are not found, the port will fail.
.TP
.B \fB\-\-no_screens\fP
Skips start\-up screens and the ending promo pages (AOG SW).
.TP
.B \fB\-\-cheats\fP
Enables so called "debug mode" without much fuss.
.TP
.B \fB\-\-data_dir\fP dir
Specifies a directory with game\(aqs resource files.
Default: \fI/usr/share/games/bstone\fP
.TP
.B \fB\-\-mod_dir\fP dir
Specifies a directory with mod\(aqs resource files.
Default: undefined.
.TP
.B \fB\-\-profile_dir\fP dir
Overrides default directory of the game\(aqs profile files.
Default: \fI~/.local/share/bibendovsky/bstone/\fP
.TP
.B \fB\-\-vid_renderer\fP value
Select a renderer.
Values:
.INDENT 7.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
auto_detect \- tries to select the best renderer.
.IP \(bu 2
software \- the vanilla renderer.
.IP \(bu 2
gl_2_0 \- OpenGL 2.0 or higher.
.IP \(bu 2
gl_3_2_c \- OpenGL 3.2 core or higher.
.IP \(bu 2
gles_2_0 \- OpenGL ES 2.0 or higher.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
Default: auto_detect
.TP
.B \fB\-\-vid_width\fP width
Specifies window width.
Minimum width: 320
Default width: 640
.TP
.B \fB\-\-vid_height\fP height
Specifies window height.
Minimum height: 240
Default height: 480
.TP
.B \fB\-\-vid_x\fP offset
Sets a horizontal offset from the left side of the desktop screen.
Applicable for positionable window only.
Default: 0
.TP
.B \fB\-\-vid_y\fP offset
Sets a vertical offset from the top side of the desktop screen.
Applicable for positionable window only.
Default: 0
.TP
.B \fB\-\-vid_is_positioned\fP value
Centers a window on the desktop or moves it in the specified position.
Values: 0 (centered) or 1 (positioned)
Default: 0
.TP
.B \fB\-\-vid_is_vsync\fP value
Enables or disables vertical synchronization.
Values: 0 (disable) or 1 (enable)
Default: 1
.TP
.B \fB\-\-vid_is_widescreen\fP value
Enables or disables widescreen rendering.
Values: 0 (disable) or 1 (enable)
Default: 1
.TP
.B \fB\-\-vid_is_ui_stretched\fP value
Stretches the UI or keeps it at 4x3 ratio otherwise.
Values: 0 (non\-stretched) or 1 (stretched)
Default: 0
.TP
.B \fB\-\-vid_2d_texture_filter\fP filter
Sets texturing filter for UI.
Applicable only for 3D\-rendering.
Values: nearest or linear
Default: nearest
.TP
.B \fB\-\-vid_3d_texture_image_filter\fP filter
Sets texturing image filter for the scene.
Applicable only for 3D\-rendering.
Values: nearest or linear
Default: nearest
.TP
.B \fB\-\-vid_3d_texture_mipmap_filter\fP filter
Sets texturing mipmap filter for the scene.
Applicable only for 3D\-rendering.
Values: nearest or linear
Default: nearest
.TP
.B \fB\-\-vid_3d_texture_anisotropy\fP value
Sets anisotropy degree for the scene.
Value 1 or lower disables the filter.
Applicable only for 3D\-rendering.
Values: [1..16]
Default: 1
.TP
.B \fB\-\-vid_texture_upscale_filter\fP filter
Sets texturing upscale filter.
Applicable only for 3D\-rendering.
Values: none or xbrz
Default: none
\fBWARNING\fP xbrz is a high resource usage filter!
.TP
.B \fB\-\-vid_texture_upscale_xbrz_degree\fP degree
Sets a degree of xBRZ texturing upscale.
Applicable only for 3D\-rendering.
Values: [2..6]
Default: 0
.TP
.B \fB\-\-vid_aa_kind\fP value
Sets an anti\-aliasing mode.
Applicable only for 3D\-rendering.
Values: none or msaa
Default: none
.TP
.B \fB\-\-vid_aa_degree\fP value
Sets a degree of the anti\-aliasing.
Applicable only for 3D\-rendering.
Values: [2..32]
Default: 1
.TP
.B \fB\-\-vid_filler_color_index\fP value
Sets a color for screen bars.
Values: [0..255]
Default: 0
.TP
.B \fB\-\-vid_external_textures\fP value
Toggles external textures.
Values: 0 (disable), 1 (enable).
Default: 0
.TP
.B \fB\-\-snd_is_disabled\fP value
Enables or disables audio subsystem.
Values: 0 (disable) or 1 (enable)
Default: 0
.TP
.B \fB\-\-snd_rate\fP sampling_rate
Specifies sampling rate of mixer in hertz.
Default: 44100
Minimum: 11025
.TP
.B \fB\-\-snd_mix_size\fP duration
Specifies mix data size in milliseconds.
Default: 40
Minimum: 20
.TP
.B \fB\-\-snd_driver\fP value
Specifies the audio driver to use.
Values: auto\-detect, 2d_sdl (2D SDL), 3d_openal (3D OpenAL)
Default: auto\-detect
Auto\-detect order: 3d_openal, 2d_sdl
.TP
.B \fB\-\-snd_oal_library\fP value
Specifies OpenAL driver\(aqs name.
Default: "" (OpenAL32.dll on Windows and libopenal.so on non\-Windows system).
.TP
.B \fB\-\-snd_oal_device_name\fP value
Specifies OpenAL device name.
Default: ""
.TP
.B \fB\-\-snd_sfx_type\fP value
Specifies SFX type.
Values: adlib (AdLib) or pc_speaker (PC Speaker)
Default: adlib
.TP
.B \fB\-\-snd_is_sfx_digitized\fP value
Toggles SFX digitization.
If enabled overrides AdLib / PC Speaker SFX audio chunk if such one is available in AUDIOT.* file.
Values: 0 (disable) or 1 (enable)
Default: 1
.TP
.B \fB\-\-snd_opl3_type\fP value
Specifies OPL3 emulator type.
Values: dbopl (DOSBox) or nuked (Nuked)
Default: dbopl
.TP
.B \fB\-\-calculate_hashes\fP
Calculates hashes (SHA\-1) of all resource files and outputs them into the log.
.TP
.B \fB\-\-extract_vga_palette\fP dir
Extracts VGA palette into existing directory dir.
Supported file format: \fB\&.bmp\fP
.TP
.B \fB\-\-extract_walls\fP dir
Extracts graphics resources (wall, flooring, etc.) into existing directory dir.
Supported file format: \fB\&.bmp\fP
.TP
.B \fB\-\-extract_sprites\fP dir
Extracts graphics resources (actors, decorations, etc.) into existing directory dir.
Supported file format: \fB\&.bmp\fP
.TP
.B \fB\-\-extract_music\fP dir
Extracts music resources into existing directory dir.
Supported file format: \fB\&.wav\fP
Supported file format: data (unprocessed)
.TP
.B \fB\-\-extract_sfx\fP dir
Extracts sfx resources into existing directory dir.
Supported file format: \fB\&.wav\fP
Supported file format: data (unprocessed)
.TP
.B \fB\-\-extract_texts\fP dir
Extracts text resources into existing directory dir.
Supported file format: \fB\&.txt\fP
.TP
.B \fB\-\-extract_all\fP dir
Extracts all resources (walls, sprites, etc.) into existing directory dir.
.UNINDENT
.SH COPYRIGHT
.sp
See the file /usr/doc/bstone\-1.1.12/LICENSE for license information.
.SH AUTHORS
.sp
bstone was written by Boris I. Bendovsky, based on an original
game by JAM Productions, published by Apogee Entertainment, LLC.
.sp
This man page written for the SlackBuilds.org project
by B. Watson, and is licensed under the WTFPL.
.SH SEE ALSO
.sp
The bstone homepage: \fI\%http://bibendovsky.github.io/bstone/\fP
.\" Generated by docutils manpage writer.
.
